home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / prgtools / gnustuff / tos / othergnu / texinf~1.zoo / texinfo.st / README.src < prev   
Encoding:
Text File  |  1993-06-29  |  3.4 KB  |  69 lines
  1. This directory contains a set of modified sources for an (updated) ST
  2. port for FSF system of documentation called `Texinfo'.  Documents
  3. prepared in this system can be either typeset in a book form (with
  4. TeX, but also with troff), or displayed on-line with hypertext
  5. capabilities on character based terminals.
  6.  
  7. These sources and provided makefiles are for ST version of gcc
  8. compiler.  They compile and work both without and with -mshort option
  9. (16-bit wide integers).  Still correctness of the second variant of
  10. this compilation depends on a presence of prototypes and I would be
  11. surprised if that would work with non-ANSI compilers.  With other ANSI
  12. compiler and a reasonable library you should be OK.
  13.  
  14. Sources for `makeinfo' and `texindex' are based on the the current
  15. (3.1) Texinfo distribution.  Unfortunately `info' from the same set,
  16. although provides many new capabilities, is considered "beta".  This
  17. really means that it is so far quite buggy and has obvious "memory
  18. stomping" problems.  Therefore `info' from texinfo-2.16 sources was
  19. used instead.  If you feel brave and would like to work on a port of
  20. the latest info you may contact me and I will provide patches which
  21. improve them somewhat, but they will be still far from perfect.  I
  22. would recommend for such work a machine with MMU, like a Falcon, for
  23. example.  Sources for `texi2roff' are older and are originally
  24. distributed separately as texi2roff-2.0.  They undoubtely can use
  25. updates, expansion and fixes.  Any troff wizzards are welcome.
  26.  
  27. Original complete sources are on a bigger side and contain, among
  28. other things, over .5 Meg of documentation and other goodies.  If you
  29. are seriously interested in Texinfo you should consider retrieving
  30. them from usual archives which carry GNU software.  prep.ai.mit.edu is
  31. one of location.
  32.  
  33. Binaries compiled from these sources are posted to comp.binaries.atari.st.
  34. If you got that from atari.archive you have them already.
  35.  
  36. Files produces by makeinfo on ST and on a Unix machine are
  37. interchangable with an exception of "external" names, which had to be
  38. squeezed on ST into an 8+3 scheme.  Internally they are the same.
  39. Also info.ttp will not distinguish between info files with CR/LF line
  40. terminators, or only LF.  On Unix side you will have to remove
  41. superfluous carriage returns.  This means that you can "borrow" ready
  42. info files from your nearest Unix machine (modifying names in an
  43. obvious, upon examination, way).  On the other hand, I successfully
  44. formatted on Mega with 2.5 Megs of memory the full 550 K of an
  45. original Texinfo manual (this required separate run with
  46. `--only-split' to divide into parts a monolitic .inf file from the
  47. first run).
  48.  
  49. Enjoy,
  50. Michal Jaegermann
  51. ntomczak@vm.ucs.ualberta.ca
  52. michal@gortel.phys.ualberta.ca
  53.  
  54. Note about findfile():
  55. info and makeinfo, as provides, use a modified findfile() function
  56. which is using comma and colon for path separators, but a colon which
  57. follow a single letter opening path element and followed by a slash
  58. or backslash is taken literally.  That means that specifications
  59. like
  60.      c:/tmp:c:/lib/info
  61.      c:\tmp,c:\lib\info
  62.      /dev/c/tmp:/dev/c/lib/info  (with gcc libraries)
  63. are all equivalent.  If you really want to specify in your path
  64. subdirectory 'c' of your current directory and which is followed by
  65. other path entries (not likely, but maybe) use then './c' or '.\c' as
  66. its name.  Otherwise confusion will follow.  If for some reasons
  67. you are unhappy with this convention do not use findfile.c from libtxi
  68. subdirectory.
  69.